Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Device Communications Messages

GXFinishSendPage

QuickDraw GX sends the GXFinishSendPage message after all of the data for a page has been sent to the printer. You can override the GXFinishSendPage message to perform some action at the end of a page. Your override of the GXFinishSendPage message must match the following formal declaration:

OSErr MyFinishSendPage (void);

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX's default implementation of the GXImagePage message sends the GXFinishSendPage message after the page is sent to the printer and before it starts sending the next page.

The default implementation of the GXFinishSendPage message handles PAP, serial, and not-connected connections. You override this message to perform some action at the end of the page, such as telling the printer to print the page that is loaded into its memory or prompting the user to add paper for a manual-feed print job.

SPECIAL CONSIDERATIONS

You never send the GXFinishSendPage message yourself.

If you are implementing a nonsupported type of communications connection, you need to perform a total override of the GXFinishSendPage message. Otherwise, you need to perform your tasks and then forward the message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXFinishSendPage message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The GXImagePage message is described on page 4-94.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help